home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / text / misc / nroffamiga.readme < prev    next >
Text File  |  1992-08-13  |  2KB  |  48 lines
  1. Short: nroff for the Amiga, sick version
  2.  
  3. This is my pseudo-port of nroff for the Amiga.  Basically, I just
  4. compiled the code with GCC 2.1, so it's not really a port.  I left out
  5. the source code, since it's publically available elsewhere and I made
  6. no changes (at least as far as I remember...).  I was going to include
  7. it just for those of you who like to see such things, but, when I
  8. tried to compile it again, it blew up.  Can't remember exactly how I
  9. did it the first time, but the thing works now.  Sort of.
  10.  
  11. I've included the nroff-formatted manual (you can view it with nroff,
  12. you see) as nroff.1, along with the original README file.  This
  13. package was an Atari TOS thing in the beginning, and it was the only
  14. nroff I could find <sigh>.  The file tmac.an is the manual command
  15. file distributed with the package, and tmac.lha is a set of tmac file
  16. from my local Sun host.  Copy these files to the directory TMAC:, and
  17. try nroff -man nroff.1 to see it in action.  If you have a real shell,
  18. you might want to set up an alias to run this style command through
  19. 'more', so that maybe you can read it all.  Note that nroff is likely
  20. to have severe problems with any imported roff files, and will dump
  21. these to standard error as it processes the source.
  22.  
  23. I'm no roff wizard, so I can't help much if you have problems.  A few
  24. notes, however:
  25. 1) I use the tmac.an from the tmac.lha archive rather than the one
  26. distributed.  It seems to work more often.
  27. 2) If nroff chokes on something that looks like a comment, e.g.,
  28. nroff: Don't understand ." Copyright 1987 University of California,
  29.     Berkeley 
  30. try changing the first several characters to the triad .\" -- it's the
  31. only comment token this nroff seems to understand.
  32. 3) Look at lots of roff files on a Unix system, alongside the ASCII or
  33. ANSI equivalent file, to see what sorts of things you can do with a
  34. new file or change in an ugly one.
  35.  
  36. Hope this is useful to someone.
  37.  
  38. --dgc
  39. dgc3@midway.uchicago.edu
  40.  
  41. P.S.  --Note that since this is compiled under GCC2.1, you need v37+
  42. of the ixemul.library loaded into your system.  Do this however you
  43. wish, by putting it into libs: or by using a "loadlib"-type program.
  44.  
  45. P.P.S -- The command "nroff -mark noah.1" will try to load the file
  46. "tmac:tmac.ark" before processing the file "noah.1".  You begin to see
  47. a pattern?
  48.